home *** CD-ROM | disk | FTP | other *** search
/ MacHack 2000 / MacHack 2000.toast / pc / The Hacks / MacHacksBug / README < prev   
Encoding:
Text File  |  2000-06-23  |  2.1 KB  |  68 lines

  1. MacHacksBug                                        
  2. ftp://altus.drgw.net/pub/machacksbug/
  3.  
  4. By                                         
  5. Troy Benjegerdes <troy@blacklablinux.com>    
  6. Douglas Clarke    <dclark@teraglobal.com>            
  7.  
  8. with help from                                    
  9. Eric Raymond                                    
  10. Ben Martz
  11. Bob Desoff
  12.  
  13.  
  14.  
  15.  
  16. MacsHacksBug
  17.  
  18. Is a collabrative debugger front end for GDB on Linux and MacOS X PowerPC systems.
  19. The front-end can be run on any platform supporting the Python scripting language
  20. with TCL/TK extensions for Python. This includes (but is definitely not limited to):
  21. MacOS, Linux, Windoze, various unices (probably including OS X and NeXT)
  22.  
  23. It serves two purposes: 
  24.  
  25.     * Provide a familiar looking environment for migrating from Classic MacOS
  26.       to OS X
  27.  
  28.     * Provide a collaborative environment for multiple people to aid in debugging
  29.       or teaching envinronment. This is particularly effective when accomponied by
  30.       video conferencing supplied by someone like: (boo, hiss, marketing) TeraGlobal ;)
  31.       
  32. The following macsbugs commands are supported:
  33.  
  34.     s            step instruction
  35.     t            step over
  36.     ip            assembly instruction listing from program counter
  37.     il            assembly instruction listing around the PC
  38.     ips/ils        source listing around around pc (very special dcmd) :P        
  39.     sc            stack crawl (not related to the watermelon crawl)
  40.     
  41.     
  42. In addition, it supports all the GDB instructions plus a macsbugs style register, history,
  43. and listing window. The register and listing windows are updated by the macsbugs style commands
  44. and the following GDB commands:
  45.  
  46.     step, stepi, next, nexti, run
  47.     
  48.     
  49. How to use:
  50.  
  51. Edit the file MacHacksBug.py with bbedit (don't double click it)
  52. and change the HOST, USER, and PASS to reflect the machine you will be debugging on.
  53.  
  54. Double click on the MacHacksBug.py file
  55.  
  56. type 'connect' to connect to a linux machine, and 'connect_X' to connect to an OS X
  57. machine. FYI, the 'screen' program must be installed on the target machine.
  58.  
  59. use the 'file the_buggy_file' and the run command to get going.
  60. Happy debugging.
  61.  
  62. TODO:
  63.     
  64. Uh, actually not hardcode the target address, username, and password.
  65. Get Airport working on linux.
  66. Not hang if the remote machine isn't there.
  67. Exit with some sense of grace
  68.